EditInLinkAttempted

Inside Macintosh: OpenDoc Class Reference /: Part 1 - Classes and Methods / ODPart

EditInLinkAttempted
The EditInLinkAttempted method should return a Boolean value that indicates whether this part maintains the destination of a link that includes the embedded frame.
ODBoolean EditInLinkAttempted (in ODFrame frame);
frame
A reference to an embedded frame, in which the edit was attempted, of this part.
return value
kODTrue if this part maintains the destination of a link that includes the embedded frame, otherwise kODFalse.

DISCUSSION
OpenDoc calls this method to notify this part that an attempt was made to edit content within a frame embedded in the destination of a link maintained by this part. The frame may be embedded at any depth within this part or its embedded parts.
Without making itself active, your part should display an alert box informing the user of the attempted edit to linked content and allow the user to find the source of the link or to break the link. If the user chooses to break the link, your part should change the link status of the embedded frame; the user can then retry the editing operation in the still-active frame.
Your part's EditInLinkAttempted method is not called by most parts. If your part's active frame is within a link destination and the user attempts to edit its content, you call the frame's EditInLink method instead of this method.

OVERRIDING
When you subclass ODPart, you should override this method if you support linking and embedding. Your override method must not call its inherited method; that is, your override method must implement this method's functionality completely. This method needs to be implemented only by container parts that support linking.

EXCEPTIONS

kODErrDoesNotLink
This part does not support linking.

SEE ALSO
The ODFrame::EditInLink method (page 318).
Table 2-1 on page 89 in OpenDoc Programmer's Guide.
"Editing a Link Destination" on page 393 in OpenDoc Programmer's Guide.